home *** CD-ROM | disk | FTP | other *** search
/ Nebula 1 / Nebula One.iso / Internet / WWW / Perl_WWW_Utilities / total / rand_link / README < prev   
Encoding:
Text File  |  1996-01-02  |  4.4 KB  |  92 lines
  1. ##############################################################################
  2. # Random Link Generator
  3. # Created By Matt Wright
  4. # Version 1.0
  5. # Created on 7/15/95            Last Modified On 7/30/95
  6. # I can be reached at:          mattw@misha.net
  7. # Scripts Found at:        http://worldwidemart.com/scripts/
  8. ##############################################################################
  9. # If you run into any problems while trying to configure this scripts, help  #
  10. # is available.  The steps you should take to get the fastest results, are:  #
  11. #       1) Read this file thoroughly                         #
  12. #       2) Consult the Matt's Script Archive Frequently Asked Questions:     #
  13. #               http://www.worldwidemart.com/scripts/faq/                 #
  14. #       3) If you are still having difficulty installing this script, send   #
  15. #          e-mail to: scripts-help@tahoenet.com                     #
  16. #          Include any error messages you are receiving and as much detail   #
  17. #          as you can so we can spot your problem.  Also include the variable#
  18. #          configuration block that is located at the top of the script.     #
  19. #                                         #
  20. # Hopefully we will be able to help you solve your problems.  Thank you.     #
  21. ##############################################################################
  22.  
  23. This Random Link Script was originally written to be part of my Free For All 
  24. Links Script, but I thought that I could also break it down and send it out as 
  25. a small script for those people wanting to run their own Random Link Page.  It 
  26. should be relatively easy to set up. 
  27. =====================================================================
  28.  
  29. There are three files included in this package.  They are:
  30.         README          - This file
  31.         rand_link.pl    - The Perl File that calls the Random Link
  32.         rand_link.html  - An Example HTML of how to call the script
  33.         rand_log        - A blank log file
  34.  
  35. =====================================================================
  36.  
  37. This is one of the more simple scripts that I have written and it only has one 
  38. variable that you must set up and another if you choose to use the logging 
  39. option.
  40.  
  41. RAND_LINK.PL
  42.         This file must be placed in the cgi-bin of your server and chmoded to 
  43. 755, so that it is readable and executable by all users.  There is one 
  44. variable in here, described below:
  45.  
  46.                 # Variables
  47.                 $linkfile = "";
  48.                         This is the database of links.  Links must be
  49.                         placed in this database, without any markup,
  50.                         one per line.
  51.  
  52.                 # Options
  53.                 $uselog = "";
  54.                         This determines whether you want to use the
  55.                         log or not.  If you do you will simply get a
  56.                         log of the Remote Host and the time they took
  57.                         the random link.  If you set this to '1' it
  58.                         turns logging on, otherwise it is off by
  59.                         default.  If you do turn this option on you
  60.                         must also fill in $logfile below.
  61.                 $logfile = "";
  62.                         This is the actual file system location of
  63.                         your log file.  It must be chmoded read/write
  64.                         (666) for everyone and placed in a directory
  65.                         with like permissions.
  66.  
  67. When you are done configuring these options you can move to the rand_link.html 
  68. file.
  69.  
  70. ----------------
  71.  
  72. RAND_LINK.HTML
  73.         This is just an example of a random link html file.  You can do 
  74. whatever you want with it, hack it up, remove it, etc.  It simply shows how 
  75. you can call the script.  The whole file really wasn't even necessary for me 
  76. to place in this package.  I could have just explained all you now need to do 
  77. is point your html browser to the rand_link.pl file.  So I could let users 
  78. take a random link simply by having the line in my html file:
  79.  
  80. <a href="http://worldwidemart.com/cgi-bin/rand_link.pl">Take a random 
  81. link!</a>
  82.  
  83. Its as simple as that.
  84. _____________________________________________________________________
  85.  
  86. Use this script freely.  All I ask is that you let me know the url of where 
  87. you are implementing this script and that you keep my name in it somewhere.  
  88. Not necessarily anywhere viewable by your users (It would be nice though), but 
  89. at least in the scripts.  Enjoy!
  90. _____________________________________________________________________
  91. Matt Wright (mattw@misha.net) - http://www.worldwidemart.com/scripts/
  92.